.. _granular_settings:

========================
Granular Settings
========================

.. note:: Feature requires a `Momentum Granular <https://www.algoryx.se/momentum-granular/>`_ license.

.. |GRANULAR_SETTINGS| image:: ../images/en/GranularSettings.png
.. |GRANULAR_SETTINGS_PULLDOWN| image:: ../images/en/GranularSettingsPullDown.png

|GRANULAR_SETTINGS|

The Granular Settings button will bring out a pull down menu with the settings related to granular functionality for the activated simulation.

|GRANULAR_SETTINGS_PULLDOWN|

The granular settings will be stored in the document.

**Number of Iterations:** The number of iterations that should be used in the iterative solver for continous granular and rigid body contacts. See :ref:`Granular Contact Model <resting_iterations_theory>` and :ref:`configuration guideline <setting_solver_iterations>`.

**Impact Iterations:** The number of impact iterations that should be used in the impact solve stage for granular contacts and iterative rigid body impacts. See :ref:`Impact Iterations <impact_iterations_theory>` and :ref:`configuration guideline <setting_solver_iterations>`.

**Enable Parallel Solver:** Specifies whether the Parallel Projected Gauss-Seidel Solver should be used for solving granular contacts and iterative rigid body contacts. See :ref:`Granular Contact Model <ppgs>`.

**Enable Float Solver:** Specifies whether the Parallel-Gauss-Seidel Solver should use 32bit float data. Enabling this increases computation speed.

**Enable Warm Starting:** Specifies if warm starting should be used in the Parallel-Gauss-Seidel Solver for granular contacts. This can be used to achieve more stable solutions over time with less iterations. See :ref:`Granular Contact Model <warm_starting_theory>`.

**External Particle Triangle Rendering:** Enables fallback rendering of particles in External Simulation when using hardware that does not support the default rendering method.

**Enable Template Convex Detection:** Determines if convex detection should be enabled for Template geometries. This reduces the geometrical complexity of convex trimeshes for increased performance.

**Convex Detection Threshold:** The detection threshold is the fraction of size of the mesh's smallest bound dimension that is allowed in vertex deviation from a perfect convex configuration.

**Characteristic Diameter:** Prints out the calculated characteristic diameter that is used to automatically calculate the proper impact threshold in a simulation. This value is determined by calculating the average characteristic diameter for the particle models currently active in the document. See :ref:`Granular Contact Model <restitution>`.

**Enable Impact Threshold:** Specifies whether an impact velocity threshold should be calculated. If a contact velocity exceeds this threshold value, a contact will be treated as a impact. See :ref:`Granular Contact Model <restitution>`.

**Estimate Characteristic Diameter:** Specifies if the impact velocity threshold should be automatically calculated from the available particle models in the document. See :ref:`Granular Contact Model <restitution>`.

**Characteristic Diameter:** Prints out the calculated characteristic diameter that is used to automatically calculate the proper impact threshold in a simulation. This value is determined by calculating the average characteristic diameter for the particle models currently active in the document. See :ref:`Granular Contact Model <restitution>`.